-
Notifications
You must be signed in to change notification settings - Fork 25.5k
Add some information on locale database to the ES docs #113587
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
Documentation preview: |
Pinging @elastic/es-docs (Team:Docs) |
Pinging @elastic/es-core-infra (Team:Core/Infra) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks great!
with ingest, output, and re-indexing. It is recommended to always use numerical fields in custom date formats, | ||
which are not affected by locale information. | ||
|
||
There can also be differences in week-date calculations using the `Y`, `W`, and `w` field specifiers. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I love how explicit the list of field specifiers is.
Would it make sense to word this advice such that we could add these three stragglers to the bullet list above, to provide one-stop-shopping for users who want to ensure they avoid this problem? I could envision a user swiping the above list and pasting it into a Jira ticket, thereby missing these three.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Possibly, however the effects are quite different for each type, and I expect users to read the whole doc
A formatter for a full date as four digit weekyear, two digit week of | ||
weekyear, and one digit day of week: `xxxx-'W'ww-e`. | ||
weekyear, and one digit day of week: `YYYY-'W'ww-e`. | ||
This uses the ISO week-date definition. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
…stic#113870) Forward-port changes from elastic#113787, and update the docs with similar information to elastic#113587
…stic#113870) Forward-port changes from elastic#113787, and update the docs with similar information to elastic#113587
There needs to be some reference to locale database in the docs